home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 20 / Cream of the Crop 20 (Terry Blount) (1996).iso / program / fact127.zip / FACT.DOC < prev    next >
Text File  |  1996-05-23  |  17KB  |  388 lines
  1.  
  2.                                  FACT v1.27
  3.  
  4.                (Revision history is at the end of this file)
  5.  
  6.                DOS utility: Freeware Archive Conversion Tool
  7.                     Freeware, copyright (c) May 23, 1996
  8.                                      by
  9.                            David Daniel Anderson
  10.                                  Reign Ware
  11.  
  12.                   ** READ REIGNWAR.TXT FOR LEGAL TERMS **
  13.  
  14. ** NEWS FLASH!  FACT support provided in the ILink Compression conference! **
  15.  
  16.  
  17. FACT is the world's ONLY freeware archive converter for DOS which preserves
  18. complete subdirectory structures and converts ALL nested archives - even
  19. those in subdirectories. (FACT is unique in this regard, as far as I know.)
  20.  
  21. FACT is easy to use, small, command-line operated, fully user-expandable AND
  22. includes full Pascal source code.
  23.  
  24. FACT also includes a companion utility (SMALLEST.EXE) which will save only
  25. the smallest of the newly converted archives.  See SMALLEST.DOC for details.
  26.  
  27.  
  28.        DOCUMENT SECTIONS                GO TO LINE NUMBER
  29.        --------------------------------------------------
  30.        Preparation, Instant Start                      40
  31.        Fast Start Information                          58
  32.        Detailed Explanation                            79
  33.        The ".INI" Files                               146
  34.        Compressor Features and Limitations            169
  35.        Duplicate Nested Archives                      280
  36.        The Future of FACT                             310
  37.        Revision History                               336
  38.  
  39.  
  40.                        //////////////////////////////
  41.                        | PREPARATION, INSTANT START |
  42.                        \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\
  43.  
  44. Preparation:
  45.  
  46. Before running FACT, put FACT.EXE and FACT.INI together in one directory.
  47. This directory need not be on the PATH -- just run c:\dir\FACT.EXE if the
  48. directory is not on the PATH.  No other FACT files are needed to run FACT.
  49.  
  50. Instant start:
  51.  
  52.   1) Follow instructions above regarding preparation.
  53.   2) Run "FACT" with no parameters to see a help screen.
  54.   3) Test thoroughly.
  55.   4) Use and enjoy!  (You may wish to use "MAKETINY.BAT".)
  56.  
  57.  
  58.                          //////////////////////////
  59.                          | FAST START INFORMATION |
  60.                          \\\\\\\\\\\\\\\\\\\\\\\\\\
  61.  
  62.    Usage :  FACT archives .NewExt [-d] [-q] [-w] [-1]
  63.  
  64.    Where :  "archives" is specification of the archives to convert.
  65.          :  ".NewExt" is the extension(s) you wish to convert them to.
  66.          :  "-d"=del - forces the original archive to be deleted.  [Optional]
  67.          :  "-q"=quiet - hides most of the compressors' messages.  [Optional]
  68.          :  "-w"=watch - causes FACT to pause after every action.  [Optional]
  69.          :  "-1"=1 level - only recompress the _primary_ archive.  [Optional]
  70.  
  71. Examples :  FACT c:\dls\*.zip .lzh
  72.          :  FACT somefile.arc .arj .zip .uc2 -d
  73.          :  FACT anyfiles.* .rar -d -q
  74.  
  75.    Hints :  DOS wildcards may be used when specifying the archives.
  76.          :  Multiple ".NewExt" new extensions may be specified at one time.
  77.  
  78.  
  79.                           ////////////////////////
  80.                           | DETAILED EXPLANATION |
  81.                           \\\\\\\\\\\\\\\\\\\\\\\\
  82.  
  83.   Command line:  FACT archives .NewExt [-d] [-q] [-w] [-1]
  84.  
  85.  
  86.   archives -  This is where you specify which archives you wish to
  87.               convert.  FACT will only convert archives which have
  88.               been defined in FACT.INI, and which FACT is able to
  89.               validate when it runs.
  90.  
  91.               You may use DOS wildcards (* and ?) when specifying
  92.               which archives to process.
  93.  
  94.               Examples:   c:\dls\*.*
  95.                           *.zip
  96.                           funnier.ar?
  97.                           d:\temp\bbs\dir01\pk*.lzh
  98.  
  99.  
  100.   .NewExt  -  Substitute the extensions used by the compressor or
  101.               compressors that you wish to use.  You may specify
  102.               more than one new extension.  Separate with spaces.
  103.               You *must* include the period at the beginning!
  104.  
  105.               Examples:   .rar
  106.                           .rar .uc2 .lzh
  107.                           .acb .ha .yc .rar .zip .arj .paq
  108.  
  109.  
  110.   -d       -  This will cause the original archive to be deleted
  111.   (delete)    when FACT is done processing.  FACT is intelligent
  112.               enough to NOT delete an archive which was simply
  113.               recompressed.  In other words, if you recompress all
  114.               the archives in a directory to ".arj", and some of
  115.               them are *already* ARJ files, FACT will not delete
  116.               any of the ARJ files.
  117.  
  118.  
  119.   -q       -  QUIET mode causes most of the messages from the
  120.   (quiet)     compressors to be hidden (sent to NUL).  A few
  121.               messages from FACT itself will still be displayed.
  122.  
  123.               QUIET and WATCH mode affect different output, so you
  124.               may use both at the same time.
  125.  
  126.  
  127.   -w       -  WATCH mode causes FACT to pause after running each
  128.   (watch)     compressor/ decompressor, and at various other times
  129.               after it has displayed something of note.
  130.  
  131.               WATCH mode is especially useful when try to remedy
  132.               problem conversions.
  133.  
  134.               QUIET and WATCH mode affect different output, so you
  135.               may use both at the same time.
  136.  
  137.  
  138.   -1       -  Only recompress the primary archive.  Do NOT recompress
  139.   (1 level)   any nested archives.  This can speed up processing.
  140.  
  141.               I recommend that all archives intended for redistribution
  142.               be processed with this switch.  Converting nested archives
  143.               may cause an installation program to function improperly.
  144.  
  145.  
  146.                             ////////////////////
  147.                             | THE ".INI" FILES |
  148.                             \\\\\\\\\\\\\\\\\\\\
  149.  
  150. Like many programs today, FACT.EXE uses an ".INI" (pronounced "in'EE")
  151. file to allow the user to "initialize" (or set) various options.
  152.  
  153. FACT.EXE and FACT.INI must be located in the same directory as each other.
  154. That is the *only* place where FACT.EXE will look for FACT.INI.
  155.  
  156. The FACT package includes three .INI files.  You may use any one of them.
  157. Simply rename it to FACT.INI and place in the same directory as FACT.EXE.
  158. This is what each contains:
  159.  
  160.    1) FACT.INI - simple INI file with definitions for just six of
  161.       the most common archives (ARC, ARJ, LZH, RAR, UC2 and ZIP).
  162.  
  163.    2) MINI.INI - same as above.  This is a backup or reference copy.
  164.  
  165.    3) FULL.INI - many more archivers defined.  Also includes instructions
  166.       for defining even more, and for revising the existing ones.
  167.  
  168.  
  169.                   ///////////////////////////////////////
  170.                   | COMPRESSOR FEATURES AND LIMITATIONS |
  171.                   \\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\
  172.  
  173. Each compressor has different features, and different command-line options
  174. to activate those features.  In most cases, FACT is not able to accomplish
  175. anything that the compressors themselves cannot.
  176.  
  177. Below is a list of features that I try to support in FACT, with accompanying
  178. notes on which compressors actually have those features.
  179.  
  180.  
  181. *) Processing subdirectories within archives.
  182.  
  183.    Very few compressors written prior to about 1991 include subdirectories
  184.    when creating archives.
  185.  
  186.    Unfortunately for people using those compressors, many programs today are
  187.    distributed with directory structures in the archive.
  188.  
  189.    For those compressors that do not include subdirectories, the directory
  190.    structure is destroyed upon conversion.  FACT awkwardly works around this
  191.    limitation by compressing each subdirectory as a separate archive.
  192.    This isn't an ideal solution, but I think it helps keeps files separated.
  193.  
  194.    The following have been tested,      | The following have been tested,
  195.    and reliably archive subdirectories  | and do NOT archive subdirectories
  196.    -------------------------------------|-----------------------------------
  197.